System.Array.Sort 方法 (TKey[], TValue[], Int32, Int32, IComparer)
方法描述
基于第一个 Array 中的关键字,使用指定的 IComparer
语法定义(C# System.Array.Sort 方法 (TKey[], TValue[], Int32, Int32, IComparer) 的用法)
public static void Sort( TKey[] keys, TValue[] items, int index, int length, IComparer comparer )
参数/返回值
参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
---|---|---|
keys | TKey[] | 从零开始的一维 Array,它包含要排序的关键字。 |
items | TValue[] | 从零开始的一维 Array,其中包含与 keys 中的关键字对应的项;如果为 null,则只对 keys 进行排序。 |
index | System-Int32 | 排序范围的起始索引。 |
length | System-Int32 | 排序范围内的元素数。 |
comparer | System-Collections-Generic-IComparer |
比较元素时使用的 IComparer |
返回值 | void |
提示和注释
keys Array 中的每个关键字在 itemsArray 中都有对应项。 当关键字在排序过程中重新定位时,itemsArray 中的对应项也同样重新定位。 因此,itemsArray 根据 keysArray 中对应关键字的排列进行排序。
如果 comparer 为 null,则 keysArray 中指定元素范围内的每个关键字均必须实现 IComparable
如果项数多于键数,您仍可以进行排序,但没有对应的键的项将不会被排序。 如果键数多于项数,您不能进行排序,这样做会引发 ArgumentException。
如果排序不能成功地完成,则结果未定义。
此方法使用 QuickSort 算法。 此实现执行不稳定排序;亦即,如果两元素相等,则其顺序可能不被保留。 相反,稳定排序则会保持相等元素的顺序。
一般情况下,此方法的运算复杂度为 O(n log n),其中 n 是 length;最坏的情况下其运算复杂度为 O(n ^ 2)。
System.Array.Sort 方法 (TKey[], TValue[], Int32, Int32, IComparer)例子
如果您使用 Ildasm.exe(MSIL 反汇编程序) 检查 Microsoft 中间语言 (MSIL),则可以看到正在调用泛型方法。
using System; using System.Collections.Generic; public class ReverseComparer: IComparer{ public int Compare(string x, string y) { // Compare y and x in reverse order. return y.CompareTo(x); } } public class Example { public static void Main() { string[] dinosaurs = { "Seismosaurus", "Chasmosaurus", "Coelophysis", "Mamenchisaurus", "Caudipteryx", "Cetiosaurus" }; int[] dinosaurSizes = { 40, 5, 3, 22, 1, 18 }; Console.WriteLine(); for (int i = 0; i < dinosaurs.Length; i++) { Console.WriteLine("{0}: up to {1} meters long.", dinosaurs[i], dinosaurSizes[i]); } Console.WriteLine("\nSort(dinosaurs, dinosaurSizes)"); Array.Sort(dinosaurs, dinosaurSizes); Console.WriteLine(); for (int i = 0; i < dinosaurs.Length; i++) { Console.WriteLine("{0}: up to {1} meters long.", dinosaurs[i], dinosaurSizes[i]); } ReverseComparer rc = new ReverseComparer(); Console.WriteLine("\nSort(dinosaurs, dinosaurSizes, rc)"); Array.Sort(dinosaurs, dinosaurSizes, rc); Console.WriteLine(); for (int i = 0; i < dinosaurs.Length; i++) { Console.WriteLine("{0}: up to {1} meters long.", dinosaurs[i], dinosaurSizes[i]); } Console.WriteLine("\nSort(dinosaurs, dinosaurSizes, 3, 3)"); Array.Sort(dinosaurs, dinosaurSizes, 3, 3); Console.WriteLine(); for (int i = 0; i < dinosaurs.Length; i++) { Console.WriteLine("{0}: up to {1} meters long.", dinosaurs[i], dinosaurSizes[i]); } Console.WriteLine("\nSort(dinosaurs, dinosaurSizes, 3, 3, rc)"); Array.Sort(dinosaurs, dinosaurSizes, 3, 3, rc); Console.WriteLine(); for (int i = 0; i < dinosaurs.Length; i++) { Console.WriteLine("{0}: up to {1} meters long.", dinosaurs[i], dinosaurSizes[i]); } } } /* This code example produces the following output: Seismosaurus: up to 40 meters long. Chasmosaurus: up to 5 meters long. Coelophysis: up to 3 meters long. Mamenchisaurus: up to 22 meters long. Caudipteryx: up to 1 meters long. Cetiosaurus: up to 18 meters long. Sort(dinosaurs, dinosaurSizes) Caudipteryx: up to 1 meters long. Cetiosaurus: up to 18 meters long. Chasmosaurus: up to 5 meters long. Coelophysis: up to 3 meters long. Mamenchisaurus: up to 22 meters long. Seismosaurus: up to 40 meters long. Sort(dinosaurs, dinosaurSizes, rc) Seismosaurus: up to 40 meters long. Mamenchisaurus: up to 22 meters long. Coelophysis: up to 3 meters long. Chasmosaurus: up to 5 meters long. Cetiosaurus: up to 18 meters long. Caudipteryx: up to 1 meters long. Sort(dinosaurs, dinosaurSizes, 3, 3) Seismosaurus: up to 40 meters long. Mamenchisaurus: up to 22 meters long. Coelophysis: up to 3 meters long. Caudipteryx: up to 1 meters long. Cetiosaurus: up to 18 meters long. Chasmosaurus: up to 5 meters long. Sort(dinosaurs, dinosaurSizes, 3, 3, rc) Seismosaurus: up to 40 meters long. Mamenchisaurus: up to 22 meters long. Coelophysis: up to 3 meters long. Chasmosaurus: up to 5 meters long. Cetiosaurus: up to 18 meters long. Caudipteryx: up to 1 meters long. */
异常
异常 | 异常描述 |
---|---|
ArgumentNullException | keys 为 null。 |
ArgumentOutOfRangeException |
|
ArgumentException |
|
InvalidOperationException | comparer 为 null,并且 keysArray 中的一个或多个元素未实现 IComparable |
版本信息
.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。